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METHOD AND APPARATUS FOR SUPPORTING 
ERROR HANDLING IN A WEB PRESENTATION 

ARCHITECTURE 

BACKGROUND OF THE RELATED ART 
[0001] This section is intended to introduce the reader to various aspects of 

art, which may be related to various aspects of the present invention that are described 
and/or claimed below. This discussion is believed to be helpful in providing the 
reader with background information to facilitate a better understanding of the various 
aspects of the present invention. Accordingly, it should be understood that these 
statements are to be read in this light, and not as admissions of prior art. 

[0002] A user may initiate a web transaction with a web application by 

sending information to the web application via a browser or the like. A web 
transaction is everything that happens from when the web application receives the 
request until it returns a response to the user. The web application may access data 
resources or otherwise obtain information from a variety of sources in response to a 
user request. 

[0003] Web applications are increasingly complex programs that, in some 

cases, process enormous amounts of information for hundreds or even thousands of 
users at a time. Error handling is an important aspect of making a user's transaction 
as trouble free as possible. Additionally, correct design of error handling aspects of a 
web application may minimize duplication of efforts by designers of web application. 



2 



PDNO:200208013-1 



[0004] Without correct error handling, web applications may be required to 

employ a different "action forward" for every type of exception. An "action forward" 
is a destination to which a controller servlet may be directed in response to a request. 
Such a system may easily become unmanageable based on the number of potential 
errors that may occur in web application processing. The use of a different "action 
forward" for each type of exception generated by a web application may greatly 
complicate the design of web applications. 

BRIEF DESCRIPTION OF THE DRAWINGS 
[0005] Advantages of one or more disclosed embodiments may become 

apparent upon reading the following detailed description and upon reference to the 
drawings in which: 

[0006] FIG. 1 is a block diagram that illustrates a model-view-controller 

("MVC") application architecture, which may be created using embodiments of the 
present invention may be employed; 

[0007] FIG. 2 is a block diagram that illustrates a web presentation 

architecture in accordance with embodiments of the present invention; 

[0008] FIG. 3 is a block diagram that illustrates the operation of error 

handling functionality in a web application program created using a web 
presentation architecture in accordance with embodiments of the present invention; 
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[0009] FIG. 4 is an object diagram of an architecture for object classes 

associated with error handling functionality in accordance with embodiments of 
the present invention; and 

[0010] FIG. 5 is an object diagram of an architecture for object classes 

associated with an error catalog in accordance with embodiments of the present 
invention. 

DETAILED DESCRIPTION 
[001 1] One or more specific embodiments of the present invention will be 

described below. In an effort to provide a concise description of these 
embodiments, not all features of an actual implementation are described in the 
specification. It should be appreciated that in the development of any such actual 
implementation, as in any engineering or design project, numerous 
implementation-specific decisions must be made to achieve the developers' 
specific goals, such as compliance with system-related and business-related 
constraints, which may vary from one implementation to another. Moreover, it 
should be appreciated that such a development effort might be complex and time 
consuming, but would nevertheless be a routine undertaking of design, fabrication, 
and manufacture for those of ordinary skill having the benefit of this disclosure. 

[0012] FIG. 1 is a block diagram that illustrates a model-view-controller 

("MVC") application architecture, which maybe created using embodiments of the 
present invention. As illustrated, the MVC architecture 10 separates the application 
object or model 12 from a view 16, which is responsible for receiving an input and 
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presenting an output to a client 14. In a web application context, the client 14 may 
comprise a browser. The model object and the view are also separated from the 
control functions of the application, which are represented in FIG. 1 as a controller 
18. In general, the model 12 comprises an application state 20, the view 16 comprises 
presentation logic 22, and the controller 18 comprises control and flow logic 24. By 
separating these three MVC objects 12, 16, and 18 with abstract boundaries, the 
MVC architecture 10 may provide flexibility, organization, performance, efficiency, 
and reuse of data, presentation styles, and logic. 

[0013] The WPA 100 may be configured with a variety of object-oriented 

programming languages, such as Java by Sun Microsystems, Inc., Santa Clara, 
California. An object is generally any item that can be individually selected and 
manipulated. In object-oriented programming, an object may comprise a self- 
contained entity having data and procedures to manipulate the data. For example, a 
Java-based system may utilize a variety of JavaBeans, servlets, Java Server Pages 
("JSPs"), and so forth. JavaBeans are independent, reusable software modules. In 
general, JavaBeans support introspection (a builder tool can analyze how a JavaBean 
works), customization (developers can customize the appearance and behavior of a 
JavaBean), events (JavaBeans can communicate), properties (developers can 
customize and program with JavaBeans), and persistence (customized JavaBeans can 
be stored and reused). JSPs provide dynamic scripting capabilities that work in 
tandem with hypertext markup language ("HTML") code, separating the page logic 
from the static elements. According to certain embodiments, the WPA 100 may be 
designed according to the Java 2 Platform Enterprise Edition (J2EE), which is a 
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platform-independent, Java-centric environment for developing, building and 
deploying multi-tiered Web-based enterprise applications online. 

[0014] The model 12 comprises a definitional framework representing the 

application state 20. For example, in a web-based application, the model 12 may 
comprise a JavaBean object or other suitable means for representing the application 
state 20. Regardless of the application or type of object, an exemplary model 12 may 
comprise specific data and expertise or ability (methods) to get and set the data (by 
the caller). The model 12 generally focuses on the intrinsic nature of the data and 
expertise, rather than the extrinsic views and extrinsic actions or business logic to 
manipulate the data. However, depending on the particular application, the model 12 
may or may not contain the business logic along with the application state. For 
example, a large application having an application tier may place the business logic in 
the application tier rather than the model objects 12 of the web application, while a 
small application may simply place the business logic in the model objects 12 of the 
web application. 

[0015] As noted above, the view and controller objects 16 and 18 separately 

address these extrinsic views and actions or business logic. For example, the model 
12 may represent data relating to a person (e.g., an address, a birth date, phone 
number, etc.), yet the model 12 is independent of extrinsic formats (e.g., a date 
format) for displaying the personal data or extrinsic actions for manipulating the 
personal data (e.g., changing the address or phone number). Similarly, the model 12 
may represent data and expertise to track time (e.g., a clock), yet the model 12 is 
independent of specific formats for viewing the clock (e.g., analog or digital clock) or 
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specific actions for manipulating the clock (e.g., setting a different time zone). These 
extrinsic formats and extrinsic actions are simply not relevant to the intrinsic behavior 
of the model clock object. One slight exception relates to graphical model objects, 
which inherently represent visually perceptible data. If the model 12 represents a 
particular graphical object, then the model 12 has expertise to draw itself while 
remaining independent of extrinsic formats for displaying the graphical object or 
extrinsic actions for creating or manipulating the graphical object. 

[0016] The view 16 generally manages the visually perceptible properties and 

display of data, which may be static or dynamic data derived in whole or in part from 
one or more model objects 12. As noted above, the presentation logic 22 functions to 
obtain data from the model 12, format the data for the particular application, and 
display the formatted data to the client 14. For example, in a web-based application, 
the view 16 may comprise a Java Server Page (JSP page) or an HTML page having 
presentation logic 22 to obtain, organize, format, and display static and/or dynamic 
data. Standard or custom action tags (e.g., jsp:useJavaBean) may function to retrieve 
data dynamically from one or more model objects 12 and insert model data within the 
JSP pages. In this manner, the MVC architecture 10 may facilitate multiple different 
views 16 of the same data and/or different combinations of data stored by one or 
more model objects 12. 

[0017] The controller 1 8 functions as an intermediary between the client 1 4 

and the model object 12 and view 16 of the application. For example, the controller 
18 can manage access by the view 16 to the model 12 and, also, manage notifications 
and changes of data among objects of the view 16 and objects of the model 12. The 
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control and flow logic 24 of the controller 18 also may be subdivided into model- 
controllers and view-controllers to address and respond to various control issues of 
the model 12 and the view 16, respectively. Accordingly, the model-controllers 
manage the models 12 and communicate with view-controllers, while the view- 
controllers manage the views 16 and communicate with the model-controllers. 
Subdivided or not, the controllers 1 8 ensure communication and consistency between 
the model 12 and view 16 and the client 14. 

[0018] In operation, the control and flow logic 24 of the controller 1 8 

generally receives requests from the client 14, interprets the client requests, identifies 
the appropriate logic function or action for the client requests, and delegates 
responsibility of the logic function or action. Requests may be received from the 
client via a number of protocols, such as Hyper Text Transfer Protocol ("HTTP") or 
HTTP with Secure Sockets Layer ("HTTPS"). Depending on the particular scenario, 
the appropriate logic function or action of the controller 18 may include direct or 
indirect interaction with the view 16 and/or one or more model objects 12. For 
example, if the appropriate action involves alteration of extrinsic properties of data 
(e.g. reformatting data in the view 16), then the controller 18 may directly interact 
with the view 16 without the model 12. Alternatively, if the appropriate action 
involves alteration of intrinsic properties of data (e.g., values of data in the model 12), 
then the controller 18 may act to update the corresponding data in the model 12 and 
display the data in the view 16. 

[0019] FIG. 2 is a block diagram illustrating an exemplary web presentation 

architecture ("WPA") 100 in accordance with certain embodiments of the present 
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invention. The illustrated WPA 100, which may be adapted to execute on a 
processor-based device such as a computer system or the like, has certain core 
features of the MVC computing strategy, and various additional features and 
enhancements to improve its architectural operation and performance. For example, 
the illustrated WPA 100 separates the model, the view, and the controller as with the 
traditional MVC architecture, yet the WPA 100 provides additional functionality to 
promote modularity, flexibility, and efficiency. 

[0020] As illustrated, the WPA 1 00 comprises a WPA controller 1 02 having 

a preprocessor 104, a localization manager 106, the navigation manager 108, a layout 
manager 1 10, a cookie manager 112, and object cache manager 114, and a 
configuration manager 116. The WPA controller 102 functions as an intermediary 
between the client 14, form objects 118, action classes 120, and views 122. In turn, 
the action classes 120 act as intermediaries for creating/manipulating model objects 
124 and executing WPA logic 126, such as an error manager 128, a performance 
manager 130, and activity manager 132, and a backend service manager 134. As 
described below, the backend service manager 134 functions to interface backend 
services 136. Once created, the model objects 124 can supply data to the view 122, 
which can also call various tag libraries 142 such as WPA tag libraries 144 and 
service tag libraries 146. 

[0021] In operation, the client 14 sends a request 148 to the WPA 100 for 

processing and transmission of a suitable response 150 back to the client 14. For 
example, the request 148 may comprise a data query, data entry, data modification, 
page navigation, or any other desired transaction. As illustrated, the WPA 100 
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intakes the request 148 at the WPA controller 102, which is responsible for various 
control and flow logic among the various model-view-controller divisions of the 
WPA 100. For example, the WPA controller 102 can be implemented as a Servlet, 
such as aHyperText Transfer Protocol ("HTTP") Servlet, which extends the 
ActionServlet class of Struts (an application framework promulgated by the Jakarta 
Project of the Apache Software Foundation). As illustrated, the WPA controller 102 
invokes a configuration resource file 152, which provides mapping information for 
form classes, action classes, and other objects. Based on the particular request 148, 
the WPA controller 102 locates the appropriate action class and, also, the appropriate 
form class if the request 148 contains form data (e.g., client data input). For example, 
the WPA controller 102 may lookup a desired WPA Action Form and/or WPA 
Action Class, which function as interfaces to WPA Form Objects and WPA Action 
Objects. 

[0022] If the client entered data, then the WPA controller 102 creates and 

populates the appropriate form object 1 18 as indicated by arrow 154. The form 
object 118 may comprise any suitable data objects type, such as a JavaBean, which 
functions to store the client entered data transmitted via the request 148. The WPA 
controller 102 then regains control as indicated by arrow 156. 

[0023] If the client did not enter data, or upon creation and population of the 

appropriate form object 1 1 8, then the WPA controller 102 invokes the action class 
120 to execute various logic suitable to the request 148 as indicated by arrow 158. 
For example, the action class 120 may call and execute various business logic or 
WPA logic 126, as indicated by arrow 160 and discussed in further detail below. The 
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action class 120 then creates or interacts with the model object 124 as indicated by 
arrow 162. The model object 124 may comprise any suitable data object type, such 
as a JavaBean, which functions to maintain the application state of certain data. One 
example of the model object 124 is a shopping cart JavaBean, which stores various 
user data and e-commerce items selected by the client. However, a wide variety of 
model objects 124 are within the scope of the WPA 100. After executing the desired 
logic, the action class 120 forwards control back to the WPA controller 102 as 
indicated by arrow 164, which may be referred to as an "action forward." This action 
forward 164 generally involves transmitting the path or location of the server-side 
page, e.g., the JSP. 

[0024] As indicated by arrow 166, the WPA controller 12 then invokes the 

foregoing server-side page as the view 122. Accordingly, the view 122 interprets its 
links or tags to retrieve data from the model object 124 as indicated by arrow 168. 
Although a single model object 124 is illustrated, the view 122 may retrieve data 
from a wide variety of model objects. In addition, the view 122 interprets any special 
logic links or tags to invoke tag libraries 142 as indicated by arrow 170. For example, 
the WPA tag libraries 144 and the service tag libraries 146 can include various 
custom or standard logic tag libraries, such as <html>, <logic>, <template> 
developed as part of the Apache Jakarta Project or the like. Accordingly, the tag 
libraries 142 further separate the logic from the content of the view 122, thereby 
facilitating flexibility and modularity. In certain cases, the tag libraries 142 also may 
interact with the model object 124 as indicated by arrow 172. For example, a special 
tag may execute logic to retrieve data from the model object 124 and manipulate the 
retrieved data for use by the view 122. After interacting with the model object 124 
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and the appropriate tag libraries 142, the WPA 100 executes the view 122 (e.g., JSP) 
to create a client-side page for the client 14 as indicated by arrow 174. For example, 
the client-side page may comprise an extended markup language ("XML") or HTML 
formatted page, which the WPA controller 102 returns to the client 14 via the 
response 150. 

[0025] As discussed above, the WPA 100 comprises a variety of unique logic 

and functional components, such as control components 104 through 116 and logic 
128 through 134, to enhance the performance of the overall architecture and specific 
features 100. These components and logic generally operate on the server-side of the 
WPA 100, yet there are certain performance improvements that may be apparent on 
the client-side. These various components, while illustrated as subcomponents of the 
controller 102 or types of logic 126, may be standalone or integrated with various 
other portions of the WPA 100. Accordingly, the illustrated organization of these 
components is simply one exemplary embodiment of the WPA 100, while other 
organizational embodiments are within the scope of the present technique. 

[0026] Turning to the subcomponents of the WPA controller 102, the 

preprocessor 104 provides preprocessing of requests by configuring portal specific 
functions to execute for each incoming request registered to the specific portal. The 
preprocessor 104 identifies the appropriate portal specific functions according to a 
preset mapping, e.g., a portal-to-function mapping in the configuration file 152. 
Upon completion, the preprocessor 104 can redirect to a remote Uniform Resource 
Identifier (URI), forward to a local URI, or return and continue with the normal 
processing of the request 148 by the WPA controller 102. One example of such a 
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preprocessing function is a locale, which is generally comprised of language 
preferences, location, and so forth. The preprocessor 104 can preprocess local logic 
corresponding to a particular portal, thereby presetting language preferences for 
subsequent pages in a particular application. 

[0027] The locale information is also used by the localization manager 1 06, 

which functions to render localized versions of entire static pages rather than breaking 
up the static page into many message strings or keys. Instead of using a single page 
for all languages and obtaining localized strings from other sources at run time, the 
localization manager 106 looks up a localized page according to a locale identifier 
according to a preset mapping, e.g., a locale-to-localized page mapping in the 
configuration file 152. For example, the capability to render static localized pages in 
the localization manager 106 is particularly useful for static information, such as 
voluminous help pages. 



[0028] The navigation manager 108 generally functions to save a users 

intended destination and subsequently recall that information to redirect the user back 
to the intended destination. For example, if the user intends to navigate from point A 
to point B and point B queries for certain logic at point C (e.g., a user login and 
password), then the navigation manager 108 saves the address of point B, proceeds to 
the requested logic at point C, and subsequently redirects the user back to point B. 

[0029] The layout manager 110 enables a portal to separate the context logic 

functioning to render the common context from the content logic functioning to 
render the content portion of the page. The common context (e.g., C-Frame) may 
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include a header, a bottom portion or footer, and a side portion or side bar, which 
collectively provides the common look and feel and navigational context of the page. 

[0030] The cookie manager 112 functions to handle multiple cookie requests 

and to set the cookie value based on the most recent cookie request before 
committing a response. For example, in scenarios where multiple action classes 
attempt to set a particular cookie value, the cookie manager 112 caches the various 
cookie requests and defers setting the cookie value until response time. In this 
manner, the cookie manager 1 12 ensures that different action classes do not erase 
cookie values set by one another and, also, that only one cookie can exist with a 
particular name, domain, and path. 

[0031] The object cache manager 1 14 enables applications to create 

customized in-memory cache for storing objects having data originating from 
backend data stores, such as databases or service based frameworks (e.g., Web 
Services Description Language "WSDL"). The in-memory cache may be customized 
according to a variety of criteria, such as cache size, cache scope, cache replacement 
policy, and time to expire cache objects. In operation, the object cache manager 1 14 
improves performance by reducing processing time associated with the data from the 
backend data stores. Instead of retrieving the data from the backend data stores for 
each individual request 148, the object cache manager 1 14 caches the retrieved data 
for subsequent use in processing later requests. 

[0032] The configuration manager 116 functions to oversee the loading of 

frequently used information, such as an error code table, into memory at startup time 
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of a particular web application. The configuration manager 116 may retain this 
information in memory for the duration of an application server session, thereby 
improving performance by eliminating the need to load the information each time the 
server receives a request. 

[0033] Turning to the WPA logic 126, the error handler or manager 128 

functions to track or chain errors occurring in series, catalog error messages based 
on error codes, and display error messages using an error catalog. The error 
catalog of the error manager 128 may enable the use of generic error pages, which 
the error manager 128 populates with the appropriate error message at run time 
according to the error catalog. 

[0034] The WPA logic function 126 may comprise performance and 

activity managers 130 and 132, which may facilitate tracking and logging of 
information associated with a particular transaction or request. The error manager 
128 may also be adapted to participate in tracking and logging operations as well. 

[0035] The service manager 134 of the WPA logic 126 functions as an 

interface between the WPA 100 and various backend services 136. In operation, 
the service manager 134 communicates with the desired backend service 136 
according to the client request 148, parses a response from the backend service 136 
to obtain the appropriate data, and pass it to the appropriate object of WPA 100. 

[0036] The following discussion relates to the implementation of error 

handling capability in a web presentation architecture. To simplify error handling, 
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errors may be categorized into three major types of exceptions. This categorization 
may simplify the forwarding to error pages or pages that should be displayed in the 
event of an error. The use of an error code catalog optimizes the error JSP pages, as 
well, by determining the message at runtime and reducing the number of JSP pages 
needed. Finally, exception chaining functionality allows the documentation of 
exceptions, which allows application developers to improve the operation of web 
applications. The general functionality of a web application constructed in 
accordance with embodiments of the present invention is described below with 
reference to FIG. 3. 

[0037] FIG. 3 is a block diagram that illustrates the operation of error 

handling functionality in a web application program created using a web 
presentation architecture in accordance with embodiments of the present invention. 
The diagram is generally referred to by the reference numeral 200. A web server 
202 hosts a web application 204, which is constructed according to a web 
processing architecture according to embodiments of the present invention. A user 
may access the web application 204 by using a browser 206 or the like. The web 
application 204 embodies a controller 205 and an error handler 208, the operation 
of which is described in detail below. The error handler 208 may interface with an 
error catalog 210, which may contain information relating to various types of 
errors that may occur during the operation of the web application 204. Upon 
initialization, the controller 205 may load error information from a configuration 
file or files 212 and make that information available for later use by storing it in 
the error catalog 210. Those of ordinary skill in the art will appreciate that the 



16 



PDNO:200208013-1 



controller 205, the error handler 208 and the error catalog 210 may comprise 
separate operating modules or may be incorporated into the web application 204. 

[0038] The error handler 208 may comprise: 1) the ability to handle 

exceptions with a unique constructor-driven chaining mechanism, and 2) an interface 
for directing the flow of an HTTP request in the event of an exception. These 
elements may operate in conjunction with the error catalog 210 to allow the web 
application 204 to determine what type of error message to display. 

[0039] In web presentation architectures constructed in accordance with 

embodiments of the present invention, defined exceptions may share a common base 
class. This class may be referred to as the WPAException class. The key feature of a 
WPAException is the ability to chain. Specifically, if a caught exception causes a 
different exception to be created and thrown, the original exception is not lost. 
Instead, the original exception may be established as the "root exception" of the new 
exception. The root exception may be passed in as a parameter to the constructor of 
the new exception. The concept of chaining may be valuable in error tracking. 

[0040] The interface for directing the flow of an HTTP request in the event of 

an exception is based on the categories of exceptions. There may be three separate 
abstract subclasses of WPAException that all exceptions must extend. In this way, 
exceptions maybe easily classified. Depending on which subclass of WPAException 
a specific exception falls into, one of two action forwards may be called, with the 
exception or an error code passed to it. In one case, the request may result in a 
standard error page being delivered, and in the other, the action forward may use a 
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key provided to its constructor to determine the page to display. By utilizing the 
inheritance hierarchy defined by WPAException classes, the interface for displaying 
a page to the user when an error has occurred may be easily implemented. The type 
of message displayed to the user may depend on the type of exception or the action 
forward that is called. In those cases, the message displayed may be determined 
using the error catalog 210, as described below. 

[0041] Exceptions may have associated error data, which may include error 

codes, stored in the error catalog 210. Some categories of exceptions may not need 
error data stored in the error catalog 210. For example, exceptions that are concrete 
subclasses (i.e. a subclass that may have instances or be instantiated rather than 
inherited) of BusinessException do not need error data in the error catalog, while 
exceptions that are concrete subclasses of SystemException and 
FrameworkException do need their error data stored. The error catalog 210 may be 
loaded based on information in a configuration file or files 212. Among that 
information are keys used for message display in an error page. When an exception 
occurs and an action forward is called, the error catalog 210 may be accessed based 
on the error code and used to determine which error message to display in the 
resulting page. In some cases, the error code catalog 210 may also be accessed 
based on the type of error action forward and used to determine the error message 
to display in the resulting page. With the error code catalog 210, error JSP pages 
may remain generic. The error message may be determined at runtime and, therefore, 
may be plugged into the framework of a JSP. 
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[0042] The following discussion relates to the structuring of exceptions and 

how an error page may be displayed to the user when exceptions occur. As set 
forth above, an abstract superclass may be defined for all exceptions. For purposes 
of illustration, that class is referred to herein as the WPAException class. Two 
abstract subclasses may be the FeatureException subclass and the 
FrameworkException subclass. The FeatureException subclass maybe used as the 
superclass for all exceptions thrown by services. The FrameworkException 
subclass may be used as the superclass for all exceptions thrown within the 
framework of a web presentation architecture constructed in accordance with 
embodiments of the present invention. 

[0043] FeatureException may be further defined to include two abstract 

subclasses: BusinessException and SystemException. Any exceptions defined by 
services must be a subclass of either BusinessException or SystemException. This 
is significant in that these distinctions may be used to determine whether an 
exception is logged. 

[0044] Information regarding each concrete subclass of SystemException 

and FrameworkException may be stored in the error catalog 210. Each service that 
defines concrete subclasses of SystemException must have an errorCode.properties 
file (such as the configuration file 212) in a specified directory that contains 
information on each concrete subclass of SystemException that the service has 
created. Concrete subclasses of FrameworkException must also have data 
recorded in an errorCode.properties file, but because those exceptions have been 
created within the framework of a web presentation architecture constructed in 
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accordance with embodiments of the present invention, they reside in the 
framework's errorCode.properties file. During the initialization of the controller 
305, the errorCode.properties file for each service and the framework may be read, 
and stored into the error catalog 210, which may be searchable by error code. 
When an exception is created, WPAException may use the error catalog 210 to 
find information about the error that will be used during logging. 

[0045] When a service needs to forward the user to another page that 

results from a caught exception, a concrete instance of a WPAErrorActionForward 
subclass (WPASystemErrorActionForward or WPABusinessErrorActionForward) 
must be created to forward the proper page. Storing data to be logged in business 
activity and error log files may be automatically handled when these action 
forwards are created. 

[0046] If exceptions occur outside of the context of the web application 

204 (for example, when action classes interact with other architectures), those 
exceptions do not have to have to be redefined as WPAExceptions. Outside 
exceptions need not be logged in error logs. Instead, those exceptions may be 
logged as part of the transaction tracking and logging functionality of a web 
application as the reason for the failed transaction. 

[0047] Web presentation architectures in accordance with embodiments of 

the present invention may provide a way to handle and log external exceptions that 
are returned as a result to an action class. For example, if a web application is 
interacting with a service architecture, services may either directly use the action 
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class associated with the service architecture (i.e. map the URI to the service 
architecture action class), or wrap the service architecture action class inside their 
own action class. The service architecture action class may automatically create 
and convert the result to any needed web presentation architecture artifacts (for 
example, WPASystemErrorActionForward). Therefore, if a service directly uses 
the service architecture action class, all error forwarding may be performed 
automatically. In that case, services need not take any extra steps for error logging. 

[0048] However, if the service wraps the service architecture action class 

and catches an exception before or after the service action instance processes the 
service request, the action class of the service may be responsible for creating its 
own WPABusinessErrorActionForward or WPASystemErrorActionForward. If 
the action class of the service wraps any action class inside it, it may be 
responsible for ensuring that logging for any exceptions that occurred in those 
wrapped action classes takes place. Because the wrapped action class may create 
its own WPAErrorActionForward, logging of exceptions within the wrapped 
action class may be performed automatically. For any wrapped action class that 
does not return a WPAErrorActionForward, the service must directly log any 
exceptions. 

[0049] For concrete subclasses of SystemException and 

FrameworkException, an error page containing a configurable title and user 
interface ("UI") message may be displayed. The error page also indicates the error 
code below the UI message. The title and the UI message keys must be defined in 
the configuration file or files 212 according to numerical error code range or 
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according to type of action forward. These keys map to messages stored in a 
configuration file in a specific predetermined directory. 

[0050] For concrete subclasses of BusinessException, the 

WPABusinessErrorActionForward constructor may comprise an extra parameter, a 
key that contains the action forward name of the page to be displayed. The 
pathname mappings may be stored in a separate configuration file such as 
configuration resource file 152 (FIG. 2). The error code maybe stored in request 
scope in case the page to be displayed needs access to that data. A request scope 
object is available during the entirety of a request cycle. Both 
WPASystemErrorActionForward and WPABusinessErrorActionForward may 
forward to a default error page unless an alternate mapping is defined. In the case 
of concrete subclasses of BusinessException, the default error page may be like the 
error page described above for concrete subclasses of SystemException and 
FrameworkException. 

[0051] The error handler 208 may comprise a plurality of classes, which 

maybe referred to as "actors." Those actors may include the following: 

Service's action class - the action class to which a service should throw an 
exception if it wants an error page to be displayed. 

WPAErrorActionForward - the abstract superclass of 
WPASystemErrorActionForward and WPABusinessErrorActionForward. 
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WPASystemErrorActionForward - what an action class should return in its 
performO method if it catches an exception that is an instance of a concrete 
subclass of SystemException or a FrameworkException. 

WPABusinessErrorActionForward - what a service's action class should return in 
its perform() method if it catches an exception that is an instance of a concrete 
subclass of BusinessException. 

ErrorlnfoBean - used by WPAErrorActionForward to store the exception's 
information so it can be accessed by the error jsp page. 

WPAException - the abstract superclass of all WPA exceptions. 

FeatureException - the abstract superclass of all service exceptions. It is a subclass 
of WPAException. 

FrameworkException - the abstract superclass of all WPA framework exceptions. 
It is a subclass of WPAException. 

BusinessException - an abstract subclass of FeatureException. All service 
business exceptions should subclass BusinessException. 

SystemException - an abstract subclass of SystemException. All service system 
exceptions should subclass SystemException. 
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Service's own exceptions - concrete subclasses of either BusinessException or 
SystemException, needed for logging and error handling. 

Programmer - the actor who defines new exceptions and uses those exceptions in 
code. 

[0052] The following use case describes a typical course of events for a 

situation in which a service throws an exception, but catches the exception and 
resolves it without displaying an error message to the user: 

1. Service's action class is called, and code is executed in the 
perform() method. 

2. Exception is thrown somewhere within the service's code, but it is 
something the service can resolve and does not require an error page 
to be displayed to the user. 

3. Service code catches the exception and deals with it accordingly. 
The exception should have been pre-defined to subclass the correct 
WPAException class. 

[0053] The following use case describes a typical course of events for a 

situation in which a service needs to display a business error page as a result of a 
caught exception: 

1. Service's action class is called, and code is executed in the 
performQ method. 
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2. Exception is thrown somewhere within the service's code, but it is 
something the service code cannot resolve on its own, therefore an 
error page must be displayed to the user. 

3. Service code throws the caught exception back up to the perform() 
method of its Action class. 

4. The perform() method catches the WPAException and returns a 
new WPABusinessErrorActionForward. The 
WPABusinessErrorActionForward constructor requires the 
WPAException cast as a BusinessException. In addition, it requires 
the HttpServletRequest, the key to the pathname of the page to be 
displayed to the user (that may be specified in configuration 
resource file 152 (FIG. 2)), and the ActionMapping. 

5. The WPABusinessErrorActionForward will use the key to find the 
path. It also uses the ErrorlnfoBean to store the error code for 
potential use in displaying to the user. The constructor also sets the 
success indicator and prompts data storage in the transaction classes 
for logging. 

6. The page is created and displayed to the user. 



[0054] The following use case describes a typical course of events for a 

situation in which a service needs to display a System error page as a result of a 
caught exception: 

1. Service's action class is called, and code is executed in the 
performQ method. 
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2. Exception is thrown somewhere within the service's code, but it is 
something the service code cannot resolve on its own, therefore an 
error page must be displayed to the user. 

3. Service code throws the caught exception back up to the performO 
method of its Action class. 

4. The performO method catches the WPAException and returns a 
new WPASystemErrorActionForward, passing it the 
WPAException cast as a SystemException, the HttpServletRequest, 
and the ActionMapping. 

5. The WPASystemErrorActionForward obtains the pathname to the 
error jsp page using the ActionMapping object in conjunction with a 
portal property that may be specified in configuration resource file 

1 52 (FIG. 2). The name of the forward must be <portal>. error. 
Then, it uses the ErrorlnfoBean to store the needed data for use in 
displaying info to the user. Currently, the data stored is the title 
key, UI message key, and error code. The exception is used to 
determine the error code, and a portion of the error code is used to 
determine the UI message key and title key for the message and title 
to be displayed. 

6. The error page is created and displayed to the user. 

[0055] The following use case describes a typical course of events for a 

situation in which a WPAFramework catches an exception that does not need to 
display an error page, but should be logged: 
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1 . A WPAFramework class catches an instance of a concrete subclass 
of FrameworkException. 

2. The WPAFramework class should throw the exception to the 
WPAController. 

3. The WPAController catches the exception, then calls the 
Transaction object's logFrameworkException(FrameworkException 
method. 

4. The logFrameworkException method logs the error data into the 
business activity manager and the error activity managers for output 
later into the log files. 



[0056] The following use case describes a typical course of events for a 

situation in which a service needs to display a Business error page as a result of an 
exception in another application or process: 

1. Service's action class is called, and code is executed in the 
performO method. 

2. Service interacts with another architecture. 

3. Service gets a business error result from another architecture. 

4. Service can't resolve the error and must display a page to the user - 
it creates a new WPABusinessErrorActionForward, passing it the 
error code of the business exception. In addition, the constructor 
requires the HttpServletRequest, the key to the pathname of the 
page to be displayed to the user (as stored in a configuration file 152 
(FIG. 2)), and the ActionMapping. 
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5 . The WPABusinessErrorActionForward will use the key to find the 
path. It also uses the ErrorlnfoBean to store the error code for 
potential use in displaying to the user. The constructor also sets the 
success indicator and prompts data storage in the transaction classes 
for logging. 

6. The page is created and displayed to the user. 

[0057] The following use case describes a typical course of events for a 

situation in which a service needs to display a System error page as a result of an 
exception in another application or process: 

1. Service's action class is called, and code is executed in the 
perform() method. 

2. Service interacts with another architecture. 

3. Service gets a system error result from another architecture. 

4. Service can't resolve the error and must display a page to the user - 
it creates a new WPASystemErrorActionForward, passing it the 
error code of the system exception. In addition, the constructor 
requires the HttpServletRequest and the ActionMapping. 

5. The WPASystemErrorActionForward obtains the pathname to the 
error JSP page using the ActionMapping object in conjunction with 
a portal property that may be specified in configuration resource file 
152 (FIG. 2). The name of the forward must be <portal>.error. 
Then, it uses the ErrorlnfoBean to store the error code. The title 
and message displayed to the user are looked up by portal and by 
error action forward and are the same for all service exceptions that 
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occurred outside of the web presentation architecture, regardless of 
which outside architecture had the error. 
6. The error page is created and displayed to the user. 

[0058] FIG. 4 is an object diagram of an architecture for object classes 

associated with error handling functionality in accordance with embodiments of 
the present invention. The diagram is generally referred to by the reference 
numeral 300. 

[0059] All the abstract exception classes may have constructors that 

include error codes. However, their concrete subclasses may not. This is because 
the error code may be hardcoded into the coding of the exception and is passed by 
the concrete exception to its superclass when it is created. 

[0060] The developer of a web application in accordance with 

embodiments of the present invention may have several different options when 
creating a new exception. WPAException has constructors that allow subclasses to 
include an error message, diagnostic context, a caught exception, or some 
combination of those when creating themselves. If the exception is a concrete 
subclass of SystemException or FrameworkException, this extra data will be 
logged to the appropriate log file when a WPASystemErrorActionForward is 
created. Framework classes that want exceptions to be logged but that do not 
require an error page to be displayed to the user must manually call 
logFrameworkException(FrameworkException fe) method on the Transaction 



29 



PDNO:200208013-1 



object. When a WPABusinessErrorActionForward is created, business activity 
status, caveat information, and error code information is recorded for later logging. 

[0061] The caught exception may be a significant parameter that facilitates 

the use of error chaining. Developers may use the caught exception parameter 
when throwing a WPAException as a result of another exception. In this manner, 
a log entry of all the exceptions involved in the exception trail may be created. 
These entries may be stored in an error trace file. 

[0062] Because WPAException is an abstract class, all constructors are 

called only by subclasses. Each concrete subclass has an errorCode value defined 
within it that is required for each superclass constructor. That code is used to look 
up data about the exception from the error catalog 210. The following constructors 
may be employed in conjunction with the WPAException class: 

private WPAException() - This forces one of the other constructors to be called, 
since the no arg constructor is private. At a minimum, each concrete subclass must 
provide an error code when calling the WPAException constructor. 

public WPAException(String errorCode) - This constructor is called when there is 
no additional information other than that included in the error catalog that should 
be written to the error log file. 
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public WPAException(String errorCode, String errorMessage) - This is used when 
the programmer would like to log an additional message, perhaps to state exactly 
what occurred. 

public WPAException(String errorCode, DiagnosticContext diagnosticContext) - 
Here, a diagnostic context object is added. The object should contain information 
about the context of the error, such as variable values, that can be used for 
debugging. 

public WPAException(String errorCode, Exception caughtException) - This 
constructor is used when the WPAException is created as a result of another 
exception being caught. Using this constructor preserves the sequence of 
exceptions for possible output to the error trace log. 

public WPAException(String errorCode, DiagnosticContext diagnosticContext, 
Exception caughtException) - When both a diagnostic context object and a caught 
exception are present, this constructor is called. It combines the added features of 
the previous two constructors. 

public static String getStackTraceFromException(Exception e) - This method 
returns the stack trace of the exception as a string, so that it can be output or 
logged. This is a static method that is used in several classes. 

various getter functions that return error name, error code, reason, diagnostic 
context, caught exception, recourse, errorlnfo, UIMsgKey 
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These allow other classes to access information about the exception. These are 
used for logging and error page display. 

getErrorlnfoO - This method creates and returns an Errorlnfo object and should 
only be used when an exception is to be logged. In web presentation architectures 
in accordance with the present invention, SystemExceptions and 
FrameworkExceptions may be the only exceptions that are logged. 

[0063] The FeatureException class is an abstract subclass of 

WPAException. Accordingly, the FeatureException class has the same types of 
constructors and may call super(<same parameters>) for each constructor. The 
following constructors may be used in conjunction with the FeatureException 
class: 

private FeatureExceptionQ - This forces one of the other constructors to be called, 
since the no arg constructor is private. At a minimum, each concrete subclass must 
provide an error code when calling the WPAException constructor. 

public FeatureException(String errorCode) - This constructor is called when there 
is no additional information other than that included in the error catalog that should 
be written to the error log file. 

public FeatureException(String errorCode, String errorMessage) - This is used 
when the programmer would like to log an additional message, perhaps to state 
exactly what occurred. 
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public FeatureException(String errorCode, DiagnosticContext diagnosticContext) - 
Here, a diagnostic context object is added. The object should contain information 
about the context of the error, such as variable values, that can be used for 
debugging. 

public FeatureException(String errorCode, Exception caughtException) - This 
constructor is used when the WPAException is created as a result of another 
exception being caught. Using this constructor preserves the sequence of 
exceptions for possible output to the error trace log. 

public FeatureException(String errorCode, DiagnosticContext diagnosticContext, 
Exception caughtException) - When both a diagnostic context object and a caught 
exception are present, this constructor is called. It combines the added features of 
the previous two constructors. 

[0063] FrameworkException is the other abstract subclass of 

WPAException and has the same types of constructors as FeatureException. The 
FrameworkException class may employ constructors similar to those discussed 
with respect to the FeatureException class. Each concrete subclass of 
FrameworkException should have an error code defined within it, and each time a 
new instance of that exception is created, the error code is passed to the appropriate 
superclass constructor. 



33 



PDNO:200208013-1 



[0064] BusinessException is one of the two abstract subclasses of 

FeatureException. Services must subclass this class for all business exceptions. 
Each concrete subclass should have an error code defined within it, and each time a 
new instance of that exception is created, the error code is passed to the appropriate 
superclass constructor. Because the class is abstract, it may have constructors that 
have the same format as FrameworkException and FeatureException. 

[0065] SystemException is the other abstract subclass of FeatureException. 

Accordingly the SystemException constructors may follow the same format as 
BusinessException, FrameworkException, and FeatureException. 

[0066] Each concrete subclass of WPAException should define an error 

code that is passed to the appropriate superclass constructor. Developers of web 
applications in accordance with embodiments of the present invention may use the 
following constructors when creating new exceptions, where ConcreteException 
should be substituted with the actual name of the concrete exception: 

public ConcreteException() - This constructor is called when there is no additional 
information other than that included in the error catalog that should be written to 
the error log file 

public ConcreteException(String errorMessage) - This is used when the 
programmer would like to log an additional message, perhaps to state exactly what 
occurred. 
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public ConcreteException(DiagnosticContext diagnosticContext) - Here, a 
diagnostic context object is added. The object should contain information about 
the context of the error, such as variable values, that can be used for debugging. 

public ConcreteException(Exception caughtException) - This constructor is used 
when the ConcreteException is created as a result of another exception being 
caught. Using this constructor preserves the sequence of exceptions for possible 
output to the error trace log. 

public ConcreteException(DiagnosticContext diagnosticContext, Exception 
caughtException) - When both a diagnostic context object and a caught exception 
are present, this constructor is called. It combines the added features of the 
previous two constructors. 

[0067] WPAErrorActionForward is an abstract superclass for action 

forwards that are created when a page must be displayed to a user due to some 
caught exception. The following constructors may be used in conjunction with the 
WPAErrorActionForward class: 

public WPAErrorActionForward(WPAException wpae, HttpServletRequest 
request, String path) - The path parameter is the path to the page that should be 
displayed. It also obtains an instance to the TransactionProxy object. 

public WPAErrorActionForward(String errorCode, HttpServletRequest request, 
String path) - The path parameter is the path to the page that should be displayed. 
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This constructor is used for interactions with other architectures, where an error 
result is returned. It also obtains an instance to the TransactionProxy object. 

protected void logErrorQ - This method calls the TransactionProxy' s logError() 
method and stores the error data in the transaction for later logging. 

protected void logBusinessActivityStatus() - This method stores the error code and 
success indicator for use in logging to the business activity log file. 

protected abstract void log() - This method must be instantiated by a concrete 
subclass. It controls storing information for logging. 

protected void setSuccessIndicator(int indicator) - This class is called by the 
subclasses to set the success indicator before the logBusinessActivityStatus() 
method is called. 

public Object clone() - This method returns a copy of this 
WPAErrorActionForward instance. 

[0068] WPABusinessErrorActionForward is a class that may be used to 

display an error page to the user after a business exception. The following 
constructors may be employed in conjunction with the 
WPABusinessErrorActionForward class: 
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public WPABusinessErrorActionForward(BusinessException e, 
HttpServletRequest request, String resultClassName, ActionMapping mapping) - 
This constructor enables the business activity data to be extracted and logged. For 
this constructor, the WPAException must be a concrete instance of a 
BusinessException. The action mapping and the resultClassName are used to get 
the path of the page to be displayed. 

public WPABusinessErrorActionForward(String businessErrorCode, 
HttpServletRequest request, String resultClassName, ActionMapping mapping) - 
This constructor is used for interactions with other architectures, where an error 
result is returned. This constructor enables the business activity data to be 
extracted and logged. For this constructor, the businessErrorCode is the error code 
of the business exception. The action mapping and the resultClassName are used 
to get the path of the page to be displayed. 

private void process() - This method extracts the data from the exception and stores 
it in the ErrorlnfoBean for possible access by JSP page. This method also calls the 
log method. 

protected void log() - This method controls storing information for logging. 

public Object clone() - This method returns a copy of this 
WP ABusinessError ActionForward instance. 
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[0069] An instance of a WPASystemErrorActionForward may be created 

when an error page should be displayed to a user because of an instance of a 
concrete subclass of SystemException or FrameworkException. The following 
constructors may be employed in conjunction with the 
WPASystemErrorActionForward class: 

public WPASystemErrorActionForward(SystemException wpae, 
HttpServletRequest request, ActionMapping mapping) - This constructor enables 
the error data to be extracted and logged. For this constructor, the WPAException 
must be a concrete instance of a SystemException. The ActionMapping object 
may be used in conjunction with a portal property specified in configuration 
resource file 152 (FIG. 2) to get the path of the error page to be displayed. 



public WP ASystemErrorActionForward(FrameworkException wpae, 
HttpServletRequest request, ActionMapping mapping) - This constructor enables 
the error data to be extracted and logged. For this constructor, the WPAException 
must be a concrete instance of a FrameworkException. The ActionMapping object 
may be used in conjunction with a portal property specified in configuration 
resource file 152 (FIG.2 ) to get the path of the error page to be displayed. 

public WPASystemErrorActionForward(String systemErrorCode, 
HttpServletRequest request, ActionMapping mapping) - This constructor is used 
for interactions with other architectures, where an error result is returned. This 
constructor enables the error data to be extracted and logged. For this constructor, 
the systemErrorCode is the error code of the system exception. The 
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ActionMapping object may be used in conjunction with a portal property specified 
in configuration resource file 152 (FIG. 2) to get the path of the error page to be 
displayed. 

private void processException() - This method extracts the data from the exception 
and stores it in the ErrorlnfoBean for display to the user. This method also calls 
the log method. 

private void processCodeQ - This method stores the error code in the 
ErrorlnfoBean for display to the user. This method also calls the log method. 

protected void log() - This method controls storing information for logging. 

public Object clone() - This method returns a copy of this 
WPASystemErrorActionForward instance. 

[0070] The WPASystemErrorActionForward may use the ErrorlnfoBean 

object to store values that are later accessed by the error JSP page for display. 
There may be getter and setter methods for error code, UI message key, and title 
key. 

[0071] The following discussion relates to the design of the error catalog 

210 (FIG. 3). The error catalog 210 may provide exceptions with a centralized 
object that may be used to look up information by error code. Each service that 
creates its own concrete subclasses of SystemException must have an 
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errorCode.properties file stored in an appropriate predetermined directory to define 
per SystemException error code the error name, error reason, and error recourse. 
Concrete subclasses of FrameworkException must also have similar error data 
recorded in an errorCode.properties file, but because those exceptions are created 
within the framework of a web presentation architecture constructed in accordance 
with embodiments of the present invention, they reside in the framework's 
errorCode.properties file. The numerical portion of the error codes should fall 
within a range that defines a general description of the error. The ranges may also 
indicate a title key and UI message key that should be used with each error when 
displaying an error page to the user. In addition, the type of error action forward 
may indicate a title key and UI message key that should be used in certain 
occasions when displaying an error page to a user. This information may be portal 
specific and portal information that may be stored in the a configuration file such 
as the configuration file 212 (FIG. 3) may be used in conjunction with the error 
action forward name to indicate title keys and UI message keys. 

[0072] As set forth above, the error catalog 210 may be populated when the 

controller 205 (FIG. 3) starts up (e.g. in the init() function of the controller 205). 
An ErrorCodeConfigurator may be among the configurators called during startup, 
and it may search for and open a configuration file for each service. Those of 
ordinary skill in the art will appreciate that a single configuration file may be used 
for storing information about all relevant services, if desired. The configuration 
file or files may be text properties files or the like. The properties are read and 
stored into an ErrorCodeMapper, then loaded into the ErrorCodeCatalog as 
ErrorCode objects or title and UI message data. 
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[0073] The functionality associated with the error catalog 210 (FIG. 3) may 

comprise a plurality of classes, which may be referred to as "actors." Those actors 
may include the following: 

WPAController - the controller (for example, the controller 205 (FIG. 3)). 

WPAConfiguratorController - the controller class that calls all the configurators, 
given the list as defined in a predetermined configuration file. 

ErrorCodeConfigurator - the configurator run during the controller initialization 
that opens the errorCode.properties file for each service. 

ErrorCodeMapper - where the data from the errorCode.properties files of the 
services are stored. 

Catalog - the abstract superclass of ErrorCodeCatalog. 

ErrorCodeCatalog - this object stores ErrorCode objects, searchable by error codes. 
This object also stores title key and UI message key data. 

ErrorCode - this object stores data about each exception: the error code, error 
name, error reason, and error recourse. 
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[0074] The following use case describes a typical course of events for a 

situation in which error data is loaded upon controller initialization: 

1 . During startup, the init() method of the controller makes the proper 
calls so the configurator classes are run (using the 

WP AConfiguratorController) . 

2. Among the configurator classes run is ErrorCodeConfigurator. 

3. ErrorCodeConfigurator.configureO is called. This method uses the 
passed in ActionServlet parameter to obtain a servletContext. The 
servletContext is used to traverse the directory tree to find each 
service's errorCode.properties file. 

4. Once found, the errorCode.properties file of each service is opened 
and the data is loaded into the singleton ErrorCodeMapper object. 

5. ErrorCodeConfigurator then calls the configure() method of 
ErrorCodeCatalog. 

6. For each property in the mapper, the catalog calls registerHandler, a 
method inherited from its superclass, Catalog. The registerHandler 
method creates an ErrorCode object for each entry that was an 
errorCode mapping in the properties file. These entries are then 
stored by error code in the "handlers" hashtable of the 
ErrorCodeCatalog. Additionally, the method isolates the uiMessage 
entries and stores them separately in a "uiMessages" hashtable the 
ErrorCodeCatalog. 
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[0075] The configuration file that is loaded by the controller at 

initialization may comprise three types of data: UI message key data, title key data 
and mapping data. The UI message key data may be defined as follows: 

<range>.<portal_name>=<UI_Msg_key> 
or 

<actionForwardName>.<portal_name>=<UIJV[sg_key> 



where the range may take into account the numbering guidelines: 

System unavailable 1 0000 to 1 0999 

Service unavailable 15000 to 15999 

Database related errors 20000 to 20999 

File System errors 25000 to 25999 

Service errors 30000 to 30999 

and where UI_Msg_key comprises: <portal name>.error.<description_of string> 
and where actionForwardName comprises the fully qualified pathname for one of 
WPASystemErrorActionForward or WPABusinessErrorActionForward. 



[0076] An example set of UI message definitions follows : 

1 0000- 1 0999 . example=example. error. system_unavail_msg 
1 5000-1 5999.example=example.error.service_unavail_msg 
20000-20999.example=example.error.db_err_msg 
25000-25999.example=example.eiror.file_sys_err_msg 
30000-30999.example=example.error.service_err_msg 

com.samplePath.WPASystemErrorActionFomard.example==example.error.service 
_unavail_msg 

com.samplePath.WPASystemErrorActionForward.example^example.error.service 
_unavail_msg 
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[0077] Title keys that are stored in configuration files may be defined 

according to the following format: 

<range>.title.<portal_name>=<Title_Msg_key> 
or 

<actionForwardName>.title.<portal_name>=<TitleJVIsg_key> 

where the range takes into account the numbering guidelines described above 
and where Title_Msg_key may comprise: 
<portal_name>.error.<description_of_string> (i.e. 
example . error . service_err_pg_title), 

and where actionForwardName comprises the fully qualified pathname for one of 
WPASystemErrorActionForward or WPABusinessErrorActionForward. 



[0078] An example follows: 

1000040999.title.example=example.error.system_unavailjgjitle 
1 5000-1 5999.title.example=example.error.service_unavail_pg_title 
20000-20999.title.example=example.error.db_err_pg_title 
25000-25999.title.example=example.error.file_sys_err_pg_title 
30000-30999.title.example=example.error.service_err_pg_title 

com.samplePath.WPASystemErrorActionForward.title.example==example.error.ser 
vice_unavail_pg_title 

com.samplePath.WPASystemErrorActionForward.title.example=example.error.ser 
vice_unavail_pg_title 

[0079] The third type of data in the errorCode.properties file is the 

mapping of error code to error name, error reason, and error recourse. An 
exemplary format for that mapping follows: 
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errorCode=errorNamel |errorReasonl (Recourse 
where the error code follows the format: 
<portal>-pl-<service>-errorCode 

[0080] An exemplary StartupException follows: 

sampleFramework-pl-sampleFramework- 

10999=StartupClassInitializationError|Error occurred during initializing startup 
classes at weblogic startup|Check startup_error.log file for any errors logged. 

[0081] FIG. 5 is an object diagram of an architecture for object classes 

associated with an error catalog in accordance with embodiments of the present 
invention. The diagram is generally referred to by the reference numeral 400. 

[0082] The ErrorCodeConfigurator class may implement the 

configure(ActionServlet) method defined in the Configurator interface. The 
ActionServlet parameter is used to locate and open the errorCode.properties files in 
the directory tree. The following method may be employed in conjunction with the 
ErrorCodeConfigurator class: 

public void configure( ActionServlet servlet). 

[0083] The ErrorCodeMapper class may store all the properties defined in 

the various service defined errorCode.properties files. It is a singleton object, and 
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therefore can be called when the ErrorCodeCatalog is being configured. A 
singleton object is an object that exists in memory such that only one of that type 
of object exists at any time in memory. Once created, a singleton object is not 
destroyed after use, like most objects, but is kept in memory until accessed again. 
The following method may be employed in conjunction with the ErrorCodeMapper 
class: 

public static ErrorCodeMapper getlnstance() - Returns the instance of the 
ErrorCodeMapper. 

[0084] The Catalog class is an abstract superclass of ErrorCodeCatalog. 

The registerHandler method that ErrorCodeCatalog inherits creates the ErrorCode 
objects from the data in the ErrorCodeMapper and stores them in a "handlers" 
hashtable. The title keys and UI message keys are also isolated and stored in a 
"uiMessages" hash table. If there is a problem encountered during this method, the 
FrameworkException RegisterHandleException is thrown. The following method 
may be employed in conjunction with the Catalog class: 

public synchronized void registerHandler(String code, String value) throws 
RegisterHandleException. 

[0085] The ErrorCodeCatalog class is a concrete subclass of Catalog that 

creates an error catalog in its configure() method. For each entry stored in the 
ErrorCodeMapper, registerHandler() is called, and either an ErrorCode object is 
created, or the entry is recognized as a title key or UI message key entry. 
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ErrorCode objects are stored in a hash table separate from the title and UI message 
hash table. The following methods may be employed in conjunction with the 
ErrorCodeCatalog class: 

public synchronized static ErrorCodeCatalog getlnstance() - ErrorCodeCatalog is a 
singleton object, so programmers may access it through its getlnstanceO method. 

public void configureQ - Creates the error catalog by accessing the 
ErrorCodeMapper and creating ErrorCode objects or storing title keys and UI 
message keys. 

[0085] The ErrorCode object holds information about an exception, as 

loaded from the errorCode.properties file, including error code, error name, error 
reason, and error recourse. In addition to the constructor, there are getter functions 
for each of the fields just named. The following constructor may be employed in 
conjunction with the ErrorCode object: 

public ErrorCode(String code,String name,String reason, String recourse). 

[0086] While the invention may be susceptible to various modifications 

and alternative forms, specific embodiments have been shown by way of example 
in the drawings and will be described in detail herein. However, it should be 
understood that the invention is not intended to be limited to the particular forms 
disclosed. Rather, the invention is to cover all modifications, equivalents and 
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alternatives falling within the spirit and scope of the invention as defined by the 
following appended claims. 
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